Magnum One

home *** CD-ROM | disk | FTP | other *** search

/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d7 / dblink13.arc / DBLINK.DOC < prev next >

Wrap

Text File | 1990-11-23 | 22.8 KB | 722 lines

D'Bridge LINK User's Guide and Technical Reference Version 1.30 - 15 December 1989 Copyright 1989 by Chris Irwin ALL RIGHTS RESERVED ------------------------------------------------------------ D'Bridge Software 800-762-4197 Credit card orders Suite 208 305-232-5245 Technical Support 15321 South Dixie Highway 305-232-9365 Data (EMAIL/BBS) Miami, Florida 33176 305-255-6460 FAX 1:1050/0 D'BridgeNet 1:18/68 Fidonet 7:48/2010 Alternet ------------------------------------------------------------ "This manual may be freely copied and distributed in its original form only. Distribution of modified copies shall be considered copyright infringement. This document is the complete User's Guide and Technical Reference for D'Bridge LINK. ALL RIGHTS RESERVED. We distribute this material on an "as-is" basis only. The current releases of this manual and/or software may be obtained free-of-charge anytime from any of the D'Bridge Support Systems located world-wide. "This is a strictly COMMERCIAL product, but a 15-day demonstration period is granted to all who request it. Copying and/or distribution of license-keys is strictly prohibited. (Except, of course for backup or archival purposes.)" D'Bridge LINK TABLE OF CONTENTS ------------------------------------------------------------------------------- Table of Contents ----------------- 1.0 Hardware/software requirements 1 1.1 D'Bridge LINK - an overview 2 1.2 Installation/Configuration 3 2.0 Command-line operation 8 2.1 Control file operation 9 3.0 Technical Support 10 3.1 Acknowledgements 11 D'Bridge LINK Hardware/Software requirements 1.0 ------------------------------------------------------------------------------- 1.0 HARDWARE/SOFTWARE REQUIREMENTS ----------------------------------- HARDWARE COMPUTER - IBM PC, XT, AT, PS/2 or compatible - 256K RAM - Monochrome, CGA, EGA, VGA, PGA adaptor and monitor - Serial port (if an external modem is used) MODEM - Hayes-compatible modem The modem used MUST be capable of using both the DTR (Data Terminal Ready) and the CD (Carrier Detect) signals. (Check Appendix "E" for a list of modems already known to be compatible) - Modem cable (if external) TELEPHONE LINE - A normal telephone line - A "cellular" phone (with a compatible modem) - Most PBX systems (check with your vendor) SOFTWARE OPERATING SYSTEM - D'Bridge LINK requires DOS 2.1 or higher - A FOSSIL communications driver such as X00 by Ray Gwinn. The X00 driver is provided with D'Bridge LINK and is the ONLY driver officially supported. OPTIONS - A Multi-tasking program or windowing program such as DESQview, Windows or TopView ------------------------------------------------------------------------------- Version 1.30, Copyright 1989 by Chris Irwin - ALL RIGHTS RESERVED 1D'Bridge LINK D'Bridge LINK - an overview 1.1 ------------------------------------------------------------------------------- 1.1 D'BRIDGE LINK - AN OVERVIEW -------------------------------- D'Bridge LINK is a simple command-line utility that allows you to send and receive files using a remote PC connected via modem. D'Bridge LINK is a WaZOO-based mailer capable of sending and receiving files using the ZMODEM protocol. This software is compatible with D'Bridge, AirMail, FrontDoor, BinkleyTerm, Opus, Fido and many other WaZOO-based EMAIL systems. D'Bridge LINK is not a full-blown EMAIL system; it is a small utility that allows computers to transmit files, request files or poll a remote system from a batch file. D'Bridge link is small; just around 60K on disk makes it small enough for even floppy-based systems and laptops to use. The software only dials out. Given the phone number and the list of files to send or request, D'Bridge LINK calls the remote system multiple times until a connection is made. Once connected, the computers exchange information then quickly hang up, resulting in low-cost communications. D'Bridge LINK can be used to retrieve "demo" software such as D'Bridge. To file-request the "demo" version of D'Bridge EMAIL System, simply type: DBLINK REQUEST 1-305-232-9365 DEMO This would cause your computer to dial the main D'Bridge Support system in Miami, Florida and request the "demo" version of our software. This would take about an hour of long-distance time at 2400 baud, returning about 800K. D'Bridge LINK: - Sends and receives files completely unattended - Fully compatible with UltraTek<tm> and WaZOO<tm> EMAIL - Supports most Hayes-compatible 300-38400 baud modems - 32-bit CRCs and interruption-recovery are used in ZMODEM transfers - Supports WaZOO-style file and update requests - Uses the new EMSI handshaking standard - Compatible with most multi-taskers such as DESQview and DoubleDOS - FREE software updates available electronically - Support systems located worldwide ------------------------------------------------------------------------------- Version 1.30, Copyright 1989 by Chris Irwin - ALL RIGHTS RESERVED 2D'Bridge LINK Installation/Configuration 1.2 ------------------------------------------------------------------------------- 1.2 INSTALLATION/CONFIGURATION ------------------------------- D'Bridge LINK is a simple program to install, but requires some knowledge of DOS. A standard text editor such as EDLIN or QEDIT is needed to alter CONFIG.SYS, AUTOEXEC.BAT and DBLINK.CTL for your particular installation. There are just four files required for D'Bridge LINK: DBLINK.EXE D'Bridge LINK executable DBLINK.CTL Control file (made with standard text editor) DLnnnnnn.KEY D'Bridge LINK license key (except "demo" copies) X00.SYS Communications device driver Follow these simple steps to install and configure DBLINK for your particular configuration. In this particular example, we are installing the software on a hard disk system in the subdirectory C:\DOS. If you want to use another directory, just substitute the desired directory. 1) Copy the release files (listed above) into a subdirectory where you want to store them. (Floppy-based systems, use the "A:" root directory.) 2) Using EDLIN or another standard text editor, edit your CONFIG.SYS file (or create one) to contain the following line: DEVICE=C:\DOS\X00.SYS E D'Bridge LINK will not function without this device driver or a compatible FOSSIL driver. For more information on other FOSSIL drivers, please contact D'Bridge Support. 3) Edit your AUTOEXEC.BAT file (or create one) to contain the following lines: SET DBLINK=C:\DOS PATH C:\DOS (or add to your current path...) ------------------------------------------------------------------------------- Version 1.30, Copyright 1989 by Chris Irwin - ALL RIGHTS RESERVED 3D'Bridge LINK Installation/Configuration 1.2 ------------------------------------------------------------------------------- 4) Edit the DBLINK.CTL file to contain specific information about your modem. D'Bridge LINK comes with a "default" configuration file that should work correctly for most 2400 baud modems, but you may need to make some changes. Following is the configuration that comes as a default with the "demo" copy: * D'Bridge LINK 1.30 - Default control file (demo copy) * To obtain a 15-day "demo" key, simply select and edit the * "call" directive for the support system of your choice. Address 1:9999/9999 System (Your system name here) Operator (Your name here) Files FILES\ Modem port COM1 Modem baud 2400 * Modem locked Modem init ATM1X1Q0V1H0S0=0S7=50 Modem dial ATDT Modem timeout 60 Max tries 30 Max connects 2 Verbose log DBLINK.LOG * D'Bridge Sales and Support/Miami Call 1-305-232-9365 * D'Bridge Sales/West * Call 1-503-292-7233 * Call 1-503-292-7237 * D'Bridge Sales/East * Call 1-215-879-3310 * D'Bridge Sales/Canada * Call 1-416-823-4521 * D'Bridge Sales/Europe * Call 31-85-459034 * D'Bridge Sales/Italy * Call 39-766-540-899 * D'Bridge Sales/UK * Call 44-1-351-7262 * D'Bridge Sales/Germany * Call 49-2381-460077 * D'Bridge Sales/Belgium * Call 32-3-8770709 * D'Bridge Sales/Sweden * Call 46-480-14302 * D'Bridge Sales/Australia * Call 61-3-848-3331 * Call 61-3-563-2496 ------------------------------------------------------------------------------- Version 1.30, Copyright 1989 by Chris Irwin - ALL RIGHTS RESERVED 4D'Bridge LINK Installation/Configuration 1.2 ------------------------------------------------------------------------------- The following directives are supported inside a DBLINK control file: ADDRESS <zone:net/node.point> This defines the Fidonet address that DBLINK will use when dialing a remote system. If there is mail waiting for this address, it will be picked-up when the system is called. ALIAS <zone:net/node.point> This defines the alternate Fidonet addresses that DBLINK will use when connecting to a remote UZAP-capable system. If there is mail waiting for this address, it will be picked-up when the system is called. SYSTEM <system name> This designates the name of your system; this will appear in the log file of the remote system as an identifier. OPERATOR <operator name> This designates the name of the primary operator. (your name) FILES <directory path> This defines the subdirectory where ALL received files will be stored. Make sure that this is a valid directory path. If the directory does not exist, it will be automatically created if possible. MODEM PORT <port name> This defines the serial communication port that D'Bridge LINK will use. Valid ports are COM1 through COM7. MODEM BAUD <baud rate> This specifies the maximum speed of your modem. Valid rates are 300, 1200, 2400, 4800, 9600, 19200 and 38400. ------------------------------------------------------------------------------- Version 1.30, Copyright 1989 by Chris Irwin - ALL RIGHTS RESERVED 5D'Bridge LINK Installation/Configuration 1.2 ------------------------------------------------------------------------------- MODEM LOCKED If you specify MODEM LOCKED, then DBLINK will always communicate with your modem at the maximum specified speed. Make sure that you have the corresponding MODEM INIT string defined telling your modem that the DTE rate is locked. MODEM INIT <initialization string> Before D'Bridge LINK dials out, it first sends the initialization string to the modem. This "init" string should tell your HAYES- compatible modem to use verbose response codes. The default that comes with D'Bridge LINK is "ATM1X1Q0V1S0=0S7=65." MODEM DIAL <dial string> This is the command sent to your modem before the phone number that actually dials the phone. This is normally "ATDT" for touch-tone lines or "ATDP" for dial service. MODEM TIMEOUT <seconds> The modem timeout specifies how many seconds to wait for a response from the modem after issuing a dial command. This should normally be set for 5 seconds greater than the "S7" register value. (Default 70) MAX TRIES <count> This specifies the maximum number of times that dialing should be attempted before terminating the program without success. This value is normally 30, but may be changed to suit your installation. MAX CONNECTS <count> This defines the maximum number of unsuccessful connects that are allowed before terminating without success. If a session fails, DBLINK will call back up to this many times. PASSWORD <session password> If you need to use a session password for a given connection, you may specify it here. Passwords may be from 1 to 8 characters and are not case-sensitive. ------------------------------------------------------------------------------- Version 1.30, Copyright 1989 by Chris Irwin - ALL RIGHTS RESERVED 6D'Bridge LINK Installation/Configuration 1.2 ------------------------------------------------------------------------------- VERBOSE LOG <filename> This designates that a verbose log file should be written to the specified file. "Verbose" means that all log entries written to the screen will be in the file. TERSE LOG <filename> This designates that a terse log file should be written to the specified file. "Terse" means that only important log entries will be written; this saves disk space, but still provides all important information. 5) If you are using a "demo" copy, you will need to select the support system that you would like to use to aquire your 15-day "demo" key. The DBLINK.CTL file supplied has all of our support sites listed as commented lines. Simply un-comment the desired support system and edit the phone number so that it will be dialed correctly for your location. 6) At this point, re-boot your computer so that the X00.SYS device driver will be installed. 7) If you are installing a "demo" copy, follow the next few steps to obtain your 15-day "demo" key from the selected support system: a) Type DBLINK and press ENTER. b) Read the license agreement and type the word "AGREE" if you want D'Bridge LINK to dial your support system for the "demo" key. c) DBLINK should then start dialing the support system selected. It will keep trying until it has connected or given up because of too many retries. If you aren't able to get a key quickly, you might try selecting a different support system. (There are 9 worldwide) ------------------------------------------------------------------------------- Version 1.30, Copyright 1989 by Chris Irwin - ALL RIGHTS RESERVED 7D'Bridge LINK Command-line operation 2.0 ------------------------------------------------------------------------------- 2.0 COMMAND-LINE OPERATION --------------------------- D'Bridge LINK provides three basic functions from the command-line: FILE-TRANSMISSION D'Bridge LINK can transmit files to a remote system by using the "SEND" option from the command-line. The format of this command is: DBLINK SEND <phone number> <filespec> <filespec> ... <filespec> <phone number> is the actual phone number to be dialed and <filespec> designates the filename(s) to be sent; this may include wildcard characters to designate more than one file at once. i.e. DBLINK SEND 232-9365 \FILES\*.ZIP FILE-REQUEST D'Bridge LINK can request that the remote system send files by using the "REQUEST" option from the command line. The format is: DBLINK REQUEST <phone number> <filespec> <filespec> ... <filespec> <phone number> is the actual phone number to be dialed and <filespec> designates the filename(s) to be requested. If a request password is needed, the format for the <filespec> is <filename>,<password>. ie. DBLINK REQUEST 1-503-555-2919 FILES HISTORY.TXT DBLINK REQUEST 232-9365 MYFILE,SECRET POLL D'Bridge LINK can be instructed to simply call the remote system to pickup any mail waiting. The format for this is simply: DBLINK POLL <phone number> <phone number> is the actual phone number to be dialed. DBLINK will call the remote system without actually transmitting any files. If there are any files on hold, they will be picked-up when connected. ie. DBLINK POLL 232-9365 ------------------------------------------------------------------------------- Version 1.30, Copyright 1989 by Chris Irwin - ALL RIGHTS RESERVED 8D'Bridge LINK Control file operation 2.1 ------------------------------------------------------------------------------- 2.1 CONTROL FILE OPERATION --------------------------- D'Bridge LINK provides the ability to combine the SEND and FILE-REQUEST options by using a control file. When DBLINK is run, it first reads the DBLINK.CTL file for parameters, but an additional control file may be specified that includes commands for either file transsmision or request: DBLINK USE <control file name> This specifies that the designated control file will be read after DBLINK.CTL to list additional parameters or file-transmisstion queues as defaults. If you use this method, the phone number and filenames must be listed in the control file. There are three additional directives that may be included in a DBLINK control file: DIAL <phone number> This specifies the actual phone number to dial. SEND <filespec> This designates a filename to send. This may include wildcard characters. Any number of SEND lines may be in a control file allowing for transmission of a large number of files in one batch. REQUEST <filespec> This designates a filename to request. This may include wildcard characters and an option password (seperated by a comma.) Any number of REQUEST lines may be in a control file. ------------------------------------------------------------------------------- Version 1.30, Copyright 1989 by Chris Irwin - ALL RIGHTS RESERVED 9D'Bridge LINK Technical support 3.0 ------------------------------------------------------------------------------- 3.0 TECHNICAL SUPPORT ---------------------- D'Bridge is a complex program and it is possible that you may experience some trouble that requires technical support. We have a technical- support number that you may call anytime from 9:00AM until 5:00PM, Monday through Friday. Please remember that we are in Miami, Florida and use EASTERN STANDARD TIME (half the year...) 305-232-5245 Miami is the primary customer-support center for D'Bridge. If you bought D'Bridge from a dealer or distributor, you might be able to get technical assistance from them. In any case, we are always here during the day to answer your questions, regarless of where you have purchased the product. ------------------------------------------------------------------------------- Version 1.30, Copyright 1989 by Chris Irwin - ALL RIGHTS RESERVED 10D'Bridge LINK Acknowledgements 3.1 ------------------------------------------------------------------------------- 3.1 ACKNOWLEDGEMENTS --------------------- RAY GWINN We wish to greatly thank Ray Gwinn for allowing us to include his excellent FOSSIL driver, X00, with the D'Bridge LINK package. Ray has worked many years to bring the X00 driver through many hardware and specification changes. We thank him greatly for being kind enough to license his software for use with D'Bridge LINK. - Airmail is a trademark of Joaquim Homrigausen - BinkleyTerm was written by Bob Hartman and Vince Perriello - Fido and Fidonet are trademarks of Tom Jennings (Fido Software) - FrontDoor is a trademark of Joaquim Homrighausen - Opus, WaZOO and YOOHOO are trademarks of Wynn Wagner III - UltraTEK is a trademark of Joaquim Homrighausen and Chris Irwin - ZIP was created by Phil Katz of PKware - ZMODEM was documented by Chuck Forsberg ------------------------------------------------------------------------------- Version 1.30, Copyright 1989 by Chris Irwin - ALL RIGHTS RESERVED 11